# 霞外籠逗留記简体中文补丁安装教程

本教程适用于 Windows。补丁需要与受支持版本的游戏配套使用；补丁不包含游戏本体。

## 安装前

1. 确认已经安装《霞外籠逗留記》，并关闭正在运行的游戏。
2. 下载最新版 `Kagerou_CN_Patch.zip`，右键选择“全部解压缩”，解压到一个方便找到的位置。不要把 ZIP 里的文件直接覆盖到游戏目录。
3. 打开解压后的补丁文件夹。若 Windows 提示是否允许运行脚本，请确认文件来自你信任的补丁发布页。

## 安装汉化

1. 双击 `启动中文补丁管理器.cmd`。
2. 在“游戏目录”一栏确认或选择游戏安装目录。目录应当直接包含 `kagerou.exe`，例如：

   - `E:\Games\Kagerou`
   - `C:\Games\Kagerou`
   - 游戏启动器“打开文件所在位置”显示的目录

   如果当前显示的路径不对，点“浏览…”，选中包含 `kagerou.exe` 的那一层文件夹，不要选补丁文件夹，也不要选 `save` 子目录。
3. 点“安装 / 更新”。等待管理器报告操作完成。
4. 可点“验证文件”检查安装结果。验证通过后，打开所选游戏目录中的 `kagerou.exe` 启动游戏。

如果游戏目录位于 `E:\Games\Kagerou`，也可以双击 `一键安装汉化.cmd`。这个快捷脚本只使用该默认路径；游戏装在其他位置时请使用补丁管理器浏览选择。

## 恢复原版

先退出游戏，再双击 `一键卸载汉化.cmd`；或者在补丁管理器里选择相同的游戏目录并点“恢复原版”。恢复程序会校验安装时保存的原版备份。它会保留存档和其他游戏文件，不要手动删除 `_Kagerou_CN_Backup`，否则将无法通过本补丁恢复原版。

## 常见情况

- **提示游戏文件版本不匹配：** 安装器发现的 EXE 或 `scr.xfl` 与受支持版本不同，因此停止写入。不要跳过哈希检查，也不要强行替换；请确认游戏版本，或使用与该版本匹配的补丁。
- **提示需要权限或无法写入：** 关闭游戏后重试。若游戏安装在 `Program Files` 等受保护目录，可右键 `启动中文补丁管理器.cmd` 并选择“以管理员身份运行”。
- **看到 PowerShell 语法解析错误：** 请从发布页重新下载最新版 ZIP，并解压到一个新文件夹后再运行。不要继续使用旧解压目录里的脚本。
- **游戏能启动但中文显示异常：** 补丁按 GBK/CP936 字符集制作。在非简体中文 Windows 环境中，可尝试使用 Locale Emulator 以“简体中文（中国）”区域设置启动游戏。

## 支持范围

安装器通过原版文件哈希检查版本，目前只接受发布说明中列出的受支持原版或已知旧预览版。汉化资源只替换 `kagerou.exe` 与 `scr.xfl`，不修改存档。安装器会在游戏目录中保存原版备份，以供恢复。

完整测试范围和仍待人工验收项目见 `游戏测试报告.md`、`汉化完成报告.md` 与 `质量检查报告.md`。
